SPECIFICATION 

IBM Docket No. STL9-2000-0055 
TO ALL WHOM IT MAY CONCERN: 

BE IT KNOWN that I, John R. Ehrman of Sunnyvale, California and citizen of the United 
States have invented new and useful improvements in 



METHOD OF, SYSTEM FOR, AND COMPUTER PROGRAM PRODUCT FOR 
CREATING AND CONVERTING TO UNICODE DATA FROM SINGLE BYTE 
CHARACTER SETS, DOUBLE BYTE CHARACTER SETS, OR MIXED 
CHARACTER SETS COMPRISING BOTH SINGLE BYTE AND DOUBLE BYTE 

CHARACTER SETS 

of which the following is a specification: 
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1 METHOD OF, SYSTEM FOR, AND COMPUTER PROGRAM PRODUCT FOR 

2 CREATING AND CONVERTING TO UNICODE DATA FROM SINGLE BYTE 

3 CHARACTER SETS, DOUBLE BYTE CHARACTER SETS, OR MIXED 

4 CHARACTER SETS COMPRISING BOTH SINGLE BYTE AND DOUBLE BYTE 

5 CHARACTER SETS 
6 

7 

8 CROSS-REFERENCE TO RELATED APPLICATIONS 

9 

1 0 Application Serial Number , filed concurrently herewith on July 1 0, 2000 

1 for DATA STRUCTURE FOR CREATING, SCOPING, AND CONVERTING TO 

123 UNICODE DATA FROM SINGLE BYTE CHARACTER SETS, DOUBLE BYTE 

1 12 CHARACTER SETS, OR MIXED CHARACTER SETS COMPRISING BOTH 

1 |i SINGLE BYTE AND DOUBLE BYTE CHARACTER SETS (ffiM Docket STL9-2000- 

1:=? 

1 SO 0068), currently co-pending, and assigned to the same assignee as the present invention; and 

1 1* Application Serial Number ' filed concurrently herewith on July 1 0, 2000 

1 f i for METHOD OF, SYSTEM FOR, AND COMPUTER PROGRAM PRODUCT FOR 

1 ^ SCOPING THE CONVERSION OF UNICODE DATA FROM SINGLE BYTE 

1 U CHARACTER SETS, DOUBLE BYTE CHARACTER SETS, OR MIXED 

2p CHARACTER SETS COMPRISING BOTH SINGLE BYTE AND DOUBLE BYTE 

2 1 CHARACTER SETS (IBM Docket STL9-2000-0069), currently co-pending, and assigned to 

22 the same assignee as the present invention. 

23 The foregoing copending applications are incorporated herein by reference. 
24 

25 

26 A portion of the Disclosure of this patent document contains material which is subject 

27 to copyright protection. The copyright owner has no objection to the facsimile reproduction by 

28 anyone of the patent document or the patent disclosure, as it appears in the Patent and 

29 Trademark Office patent file or records, but otherwise reserves all copyright rights whatsoever. 



STL9-2000-0055 



1 BACKGROUND OF THE INVENTION 

2 
3 

4 1. Field of the Invention 

5 

6 The present invention relates in general to coded character sets for representing 

7 characters in a computer program, and more particularly to a creation of Unicode characters by 

8 converting from non-Unicode characters. 
9 

10 

11 2. Description of the Related Art 

1 |=T Unicode is a new internationally standardized data encoding for character data which 

14y allows computers to exchange and process character data in any natural language text. Its most 

1 common usage is in representing each character as a sixteen-bit number. This is sometimes 

1 ^ J called a "double-byte" data representation as a byte contains eight bits. 

lb 

1 g2 Most existing computer hardware and software represents specific sets of characters in 

1 P an eight-bit code, of which ASCII (American National Standard Code for Information 

2(5 Interchange) and EBCDIC (Extended binary-coded decimal interchange code) are typical 

2 1 examples. In such an eight-bit representation (also known as a single-byte representation), the 

22 limit of two-hundred-fifty-six (256) unique numeric values imposes a restriction on the set of 

23 distinct characters that may be encoded using the two-hundred-fifty-six distinct values. Thus, it 

24 is necessary to define different sets of encodings for each desired set of characters. 
25 

26 The chosen set of characters is called a "Character Set" . Each member of the character 

27 set can be assigned a unique eight-bit numeric value ("Code Point") fi-om the set of the two- 

28 hundred-fifty-six distinct values (Code Points). A group of assignments of characters and 

29 control Sanction meanings to all available code points is called a "Code Page"; for example, the 
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1 assignments of characters and meanings to the two-hundred-fifty-six code points (0 through 

2 255) of an 8-bit code set is a Code Page. The combination of a specific set of characters and a 

3 specific set of numeric value assignments is called a "Coded Character Set". To distinguish 

4 among the many different assignments of characters to codings, each Coded Character set is 

5 assigned an individual identification number called a "Coded Character Set ID" (CCSID). 
6 

7 In situations involving ideographic scripts such as Chinese, Japanese, or Korean, a 

8 hybrid or mixed representation of characters is sometimes used. Because the number of 

9 ideographic characters greatly exceeds the two-hundred-fifty-six possible representations 

1 0 available through the use of an eight-bit encoding, a special sixteen-bit encoding may be used 

1 1 instead. To manage such sixteen-bit representations in computing systems and devices built for 
1 2=. eight-bit representations, two special eight-bit character codes are reserved and used in the 

1^ eight-bit-character byte stream to indicate a change of alphabet representation. Typically, a 

1^1 string of characters will contain eight-bit characters in a single-byte representation. When the 

1^ first of the two special character codes (commonly called a "Shift-Out" character) is 

IP encountered indicating a switch of alphabets, the bytes subsequent to the Shift-Out character 

\g are interpreted as double-byte pairs encoded in the special sixteen-bit double-byte encoding. 

1^ At the end of the double-byte ideographic string, the other special eight-bit character code 
(commonly called a "Shift-In" character) is inserted to indicate that the following eight-bit 

2|| bytes are to be interpreted as single-byte characters, as were those characters preceding the 

2^ "Shift-Out" character. This hybrid representation is sometimes also called a "double-byte 

22 character set" (DECS) representation. When such DECS strings are mixed with SECS 

23 characters, the representation is sometimes called a "mixed SECS/DCES" representation. 
24 

25 Ideographic characters may also be represented as sixteen-bit characters in strings 

26 without any SECS characters other than the special initial "Shift-Out" and final "Shift-In" 

27 character codes if they are used in a context where it is known that there are no mixtures of 

28 eight-bit characters and sixteen-bit characters. Such usage is sometimes called "pure DECS". 

29 The Shift-Out and Shift-In codes are still required as the text of the remainder of the program 
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1 may use single-byte encodings. 
2 

3 To illustrate, assume that the "Shift-Out" character is represented by the character '<' 

4 and that the "Shift-In" character is represented by the character '>'. Then each of the three 

5 representations j ust described may be written as strings of these forms : 

6 -abcDEF' SBCS string 

7 •AB<wxyz>CD' mixed SBCS/DBCS string 

8 •<wxyz>' pure DBCS string 
9 

1 0 The actual computer storage representation of each of these three character formats 

1 1 would generally be similar to the following representations. For example, the SBCS string 

.= xz. 

1 would generally appear in storage as follows: 

llj 'abcDEF' |alb|c|D|E|F| 

IP +..-+.-.+---+---+---+---+ 

Ig^ Six bytes, one byte per character 

u Li 

If 

f ^ 

lly The hexadecimal encoding of this string in a standard representation may appear as: 

1^ + — + — + — + — + — + — + 

ill I 81 1 811 83 1 C4 1 C5| C6 1 

ii +...+-.-+.--+---+---+---+ 

22 

23 After translation to Unicode, the same characters may be represented by the following bytes 

24 (shown in hexadecimal encoding): 

25 + + + + + + + + + + + + + 

26 I 00 61| 00 62| 00 63| 00 44 | 00 45| 00 46| 

27 + + + + + + + + + + + + + 

28 Twelve bytes, two bytes per character 



STL9-2000-0055 



1 Similarly, the computer storage representation of a mixed SBCS/DBCS string may 

2 generally appear as follows where *wxyz' represents the four bytes needed to encode the two 

3 ideographic DBCS characters between the Shift-Out and Shift-ta characters, and the strings 

4 indicate the specific encodings assigned to the representations of the DBCS characters: 

5 

6 + + + — + — + — + + — + + + + 

7 'AB<wxyz>CD' | A | B | < | ?? ?? | ?? ?? I > 1 C | D | 

g + + + + + 4- + + + + + 

9 Ten bytes 

10 

1 1 The hexadecimal encoding of this string in a standard representation may appear as follows 

1 2 (wherein the Shift-Out and Shift-In characters have encodings X*OE' and X'OF* respectively): 
jp +...+---+.--+.-.+.--+---+---+---+--"+---+ 
1^ I Cll C2| 0E| ??| ??| ??| ??| 0F| C3| C4| 

IJ 



m +,.. + -.- + ... + --. + --- + ---4---- + --- + --- + -- - + 



1^ When translated to Unicode, the same characters may be represented by the these bytes (shown 

18 in hexadecimal encoding): 

l|f{ + — + — + + + — + + — + — + — + — + + + 

2pl I 00 41| GO 42| ?? ?? I ?? ?? I 00 43| 00 44| 

2^ + + + + + + + — + — + — + + + + 

i. 

^ Twelve bytes, two bytes per character 

23 Note that the Shift-Out and Shift-In characters have been removed, as they are not necessary in 

24 the Unicode representation. 
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1 For the third type of character string containing pure DBCS characters, the computer 

2 storage representation may appear as follows: 

3 H- + + + + — + - - - + 

4 '<wxyz>' I < I ?? ?? I ?? ?? I > I Six bytes 

5 + + + + + — + H- 

6 The hexadecimal encoding of this string in a standard representation may appear as follows 

7 (wherein the Shift-Out and Shift-In characters have encodings X'OE* and X'OF' respectively): 
g + + + — + + — + — + 

9 I 0E| ??| ??| ??| ??t 0F| 
JQ + + + H- + + - - - + 

11 

1 2 When translated to Unicode, the same characters would be represented by the these bytes 

1 Bri (shown in their hexadecimal encoding): 

+ + + H- H- 

I ?? ?? I ?? ?? I 
Igj + + + + + 

1 |g Four bytes, two bytes per character 

1^ 

M In typical usage, many coded character sets are used to represent the characters of 

2ik various national languages. As computer applications evolve to support a greater range of 

2|? national languages, there is a corresponding requirement to encompass a great multiplicity of 

M "alphabets". For example, a software supplier in England may provide an account 

23 management program to a French company with a subsidiary in Belgium whose customers 

24 include people with names and addresses in Danish, Dutch, French, Flemish, and German 

25 alphabets. If the program creates billings or financial summaries, it must also cope with a 

26 variety of currency symbols. Using conventional technology, it may be difficult, or even 

27 impossible, to accommodate such a variety of alphabets and characters using a single eight-bit 

28 coded character set. 
29 

30 In other applications, a program may be required to present messages to its users in any 
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of several selectable national languages (this is often called "internationalization"). Creating 
the message texts requires that the program's suppliers be able to create the corresponding 
messages in each of the supported languages, which requires special techniques for handling a 
multiplicity of character sets in a single application. 

Unicode offers a solution to the character encoding problem, by providing a single 
sixteen-bit representation of the characters used in most applications. However, most existing 
computer equipment creates, manages, displays, or prints only eight-bit single-byte data 
representations. In order to simplify the creation of double-byte Unicode data, there is a need 
for ways to allow computer users to enter their data in customary single-byte, mixed 
SBCS/DBCS, and pure DBCS formats, and then have it converted automatically to the double- 
byte Unicode representation. 
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1 SUMMARY OF THE INVENTION 

2 
3 

4 The present invention comprises a method, system, article of manufacture, and a 

5 computer program product for representing characters in a computer program, and more 

6 particularly to a creation of Unicode characters by converting from non-Unicode characters. 

7 A preferred embodiment of the present invention provides methods for specifying the types of 

8 constants whose character values are to be converted to Unicode; for specifying which code 

9 page or pages are used for specifying the character encodings used in the source program for 

1 0 writing the character strings to be converted to Unicode; and that can be used to perform 

1 1 conversions from SBCS, mixed SBCS/DBCS, and pure DECS character strings to Unicode. A 
1?=. syntax suitable for specifying character data conversion from SBCS, mixed SBCS/DBCS, and 

1 33 pure DBCS representations to Unicode utilizes an extension to the conventional constant 

1 1^ subtype notation. In converting the nominal value data to Unicode, currently relevant SBCS 

1 % and DBCS code pages are used, as specified by three levels or scopes derived from either 

1 ^ global options, from local AOPTIONS statement specifications, or from constant-specific 

17" modifiers. Global code page specifications apply to the entire source program. These global 

1 % specifications allow a programmer to declare the source-program code page or code pages just 

W: once. These specifications then apply to all constants containing a request for conversion to 

M- Unicode. Local code page specifications apply to all subsequent source-program statements. 

# These local specifications allow the programmer to create groups of statements containing 

22 Unicode conversion requests, all of which use the same code page or code pages for their 

23 source-character encodings. Code page specifications that apply to individual constants allow a 

24 very detailed level of control over the source data encodings to be used for Unicode 

25 conversion. The conversion of source data to Unicode may be implemented inherently to the 

26 translator (assembler, compiler, or interpreter) wherein it recognizes and parses the complete 

27 syntax of the statement in which the constant or constants is specified, and performs the 

28 requested conversion. Alternatively, an external fiinction may be invoked by a variety of 

29 source language syntaxes which parses as little or as much of the source statement as its 
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1 implementation provides, and returns the converted value for inclusion in the generated 

2 machine language of the object program. Alternatively, the conversion may be provided by the 

3 translator's macro instruction definition facility. 
4 

5 One aspect of a preferred embodiment of the present invention provides for the 

6 specification of the types of constants whose character values are to be converted to Unicode. 
7 

8 Another aspect of a preferred embodiment of the present invention provides for the 

9 specification of which code page or pages are used for specifying the character encodings used 
1 0 in the source program for writing the character strings to be converted to Unicode. 

11 

1 2 Another aspect of a preferred embodiment of the present invention performs 

O 

1 S3 conversions fi-om SBCS, mixed SBCS/DBCS, and pure DECS character stnngs to Unicode. 

1 Another aspect of a preferred embodiment of the present invention provides a syntax 

suitable for specifying character data conversion from SBCS, mixed SBCS/DBCS, and pure 

1 ^ DBCS representations to Unicode utilizing an extension to the conventional constant subtype 
lis* notation. 

21:^ Another aspect of a preferred embodiment of the present invention converts a nominal 

2P value data to Unicode using currently relevant SBCS and DBCS code pages as specified by a 

22 level or scope. 
23 

24 Another aspect of a preferred embodiment of the present invention provides a global 

25 level or scope comprising a global code page specification which applies to an entire source 

26 program. 
27 

2 8 Another aspect of a preferred embodiment of the present invention provides a local 
29 level or scope comprising a local code page specification which applies to all subsequent 
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source-program statements. 

Another aspect of a preferred embodiment of the present invention provides an 
individual constant level or scope comprising a code page specification that applies to an 
individual constant. 

A preferred embodiment of the present invention has the advantage of providing ease of 
Unicode data creation: data can be entered into a program using familiar and customary 
techniques, and in the user's own language and preferred character sets, without having to know 
any details of SBCS, DECS, or Unicode character representations or encodings. 

A preferred embodiment of the present invention has the further advantage of providing 
an ability to handle multiple single-byte and double-byte input data encodings, each specific to 
a national language or a national alphabet. Such input data may be written in several 
convenient forms, such as SBCS, mixed SBCS/DBCS, and pure DBCS. 

A preferred embodiment of the present invention has the further advantage of providing 
a variety of scopes for specifying controls over source data representations and encodings, 
such that the user has complete control over the range of these specifications, ranging from 
global (applying to all requested conversions in the entire program), local (applying to a range 
of statements containing data to be converted) to individual or constant-specific (applying to a 
single instance of data to be converted). 

A preferred embodiment of the present invention has the further advantage of providing 
an open-ended design allowing easy addition of supported character sets, by simply providing 
additional Mapping Tables for each supported character set, and without any need to modify 
the internal logic of the translator (assembler, compiler, or interpreter) to be cognizant of such 
added character sets and tables. 
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A preferred embodiment of the present invention has the further advantage of having no 
dependence on operating system environments or run-time conversion services, which may or 
may not be available in the environment in v^hich character data in the source programs are 
being converted to Unicode and translated to machine language. 

A preferred embodiment of the present invention has the further advantage of providing 
a special language syntax specifying constants to be converted to Unicode, creating no conflicts 
with existing applications. This syntax is also a natural and intuitively familiar extension of the 
existing syntax for specifying character constants. 

A preferred embodiment of the present invention has the further advantage of having no 
need to prepare nor accept programs written using Unicode characters, and no need for 
special Unicode-enabled input/output devices or mapping software, because of the ease of data 
creation and the variety of data formats described above. 

A preferred embodiment of the present invention has the further advantage of providing 
an ability to implement conversions in multiple ways to provide flexibility, including 
implementations in the translator itself ("native" implementation), or by using macro or 
preprocessor instructions, or by utilizing the translator's support for externally-defined and 
externally-written functions. 

A preferred embodiment of the present invention has the fiirther advantage of providing 
an ability to support normal sixteen-bit Unicode and Unicode UTF-8 character formats as the 
results of converting any of the source data formats described above. 
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I BRIEF DESCRIPTION OF THE DRAWINGS 

2 
3 

4 For a more complete understanding of the present invention and the advantages thereof, 

5 reference is now made to the Description of the Preferred Embodiment in conjunction with the 

6 attached Drawings, in which: 
7 

8 Figure 1 is a block diagram of a distributed computer system used in performing the 

9 method of the present invention, forming part of the apparatus of the present invention, and 

1 0 which may use the article of manufacture comprising a computer-readable storage medium 

1 1 having a computer program embodied in said medium which may cause the computer system 
1 1^ to practice the present invention; 

1S3 

Figure 2 is a block diagram of a mapping table data structure preferred in carrying out a 

1 ^ preferred embodiment of the present invention; 

m 

17" Figure 3 and Figure 4 are flowcharts of method steps preferred in carrying out a 

\M preferred embodiment of the present invention; and 

"4 

1^ 

2£h Figures 5, 6, and 7 are listings of computer program code which implements the 

2H°' method steps preferred in carrying out a preferred embodiment of the present invention. 
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1 DESCRIPTION OF THE PREFERRED EMBODIMENT 

2 
3 

4 Referring first to Figure 1, there is depicted a graphical representation of a data 

5 processing system 8, which may be utilized to implement the present invention. As may be 

6 seen, data processing system 8 may include a plurality of networks, such as Local Area 

7 Networks (LAN) 10 and 32, each of which preferably includes a plurality of individual 

8 computers 12 and 30, respectively. Of course, those skilled in the art will appreciate that a 

9 plurality of Intelligent Work Stations (IWS) coupled to a host processor may be utilized for 

10 each such network. Each said network may also consist of a plurality of processors coupled via 

1 1 a communications medium, such as shared memory, shared storage, or an interconnection 

1 23 network. As is common in such data processing systems, each mdividual computer may be 

coupled to a storage device 14 and/or a printer/output device 16 and may be provided with a 

\ ki pointing device such as a mouse 17. 
IB 

The data processing system 8 may also include multiple mainframe computers, such as 

1 13 mainframe computer 18, which may be preferably coupled to LAN 10 by means of 

IB^ communications link 22. The mainfi:ame computer 18 may also be coupled to a storage device 

iK 20 which may serve as remote storage for LAN 10. Similarly, LAN 10 may be coupled via 

iW communications link 24 through a sub-system control unit/communications controller 26 and 

2 1 communications link 34 to a gateway server 28. The gateway server 28 is preferably an IWS 

22 which serves to link LAN 32 to LAN 10. 
23 

24 With respect to LAN 32 and LAN 10, a plurality of documents or resource objects may 

25 be stored within storage device 20 and controlled by mainframe computer 18, as resource 

26 manager or library service for the resource objects thus stored. Of course, those skilled in the 

27 art will appreciate that mainframe computer 18 may be located a great geographic distance 

28 from LAN 10 and similarly, LAN 10 may be located a substantial distance from LAN 32. For 

29 example, LAN 32 may be located in Belgium while LAN 10 may be located within England 
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1 and mainframe computer 18 may be located in New York. 
2 

3 Software program code which employs the present invention is typically stored in the 

4 memory of a storage device 14 of a stand alone workstation or LAN server from which a 

5 developer may access the code for distribution purposes, the software program code may be 

6 embodied on any of a variety of known media for use with a data processing system such as a 

7 diskette or CD-ROM or may be distributed to users from a memory of one computer system 

8 over a network of some type to other computer systems for use by users of such other systems. 

9 Such techniques and methods for embodying software code on media and/or distributing 
1 0 software code are well-known and will not be further discussed herein. 

11 

1 2:=. As will be appreciated upon reference to the foregoing, it may be desirable for a user to 

I ; 

1 §3 develop a multi-lingual or multi-alphabet software application. For example, a user of a 

software supplier in England may develop an account management program on a workstation 

iS 12 for use on a French company's computer 26 wherein the French company has a subsidiary 

1_^ in Belgium running a computer 28 which must process requests from users operating 

Id 

\¥ computers 30, each of which may be interfacing in a different language, such as Danish, Dutch, 

1^ French, Flemish, or German. The present invention provides character specification and 

1^ conversion capabilities to accommodate such a variety of alphabets and characters. 

m 

jf The following description of an assembler based preferred embodiment of the present 

22 invention assimies familiarity with the assembly language described in "IBM High Level 

23 Assembler for MVS & VM & VSE Language Reference, Release 3", fflM Manual Number 

24 SC26-4940-02, and the assembler options and extemal function interfaces described in "IBM 

25 High Level Assembler for MVS & VM & VSE Programmer's Guide, Release 3", IBM Manual 

26 Number SC26-494 1 -02. While this preferred embodiment of the present invention is described 

27 in the context of the IBM Assembler Language, it can apply to other language translators such 

28 as assemblers, compilers, and interpreters. 
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1 The invention concerns the creation of Unicode data, not its processing. The invention 

2 may be described in three ways: 

3 A. Methods for specifying the types of constants whose character values are to be 

4 converted to Unicode; 

5 B. Methods for specifying which code page or pages are used for specifying the character 

6 encodings used in the source program for writing the character strings to be converted 

7 to Unicode.; and 

8 C. Methods that can be used to perform conversions from SBCS, mixed SBCS/DBCS, 

9 and pure DBCS character strings to Unicode. 
10 

1 1 In the following descriptions, the terms "source" or "source string" refer to the 

lln characters to be converted to Unicode, and "source code page" refers to the particular encoding 

■a =r 

1 used to represent the source-string characters as numeric quantities. Similarly, the terms 

l ¥ "target" or "target string" refer to the set of Unicode characters into which the source stnng is 

1 ft bemg converted. 

li 

If Standard Syntax 

m The terminology of the IBM Assembler Language is used to specify character constants. 

M The DC ("Define Constant") instruction directs the Assembler to convert the characters 

is enclosed in apostrophes specified in the operand field to the proper machine language 

21 representation: 

22 DC C.SBCS characters...' Convert '...SBCS characters...' to the 

23 proper machine language representation. 

24 DC C'...SBCS and DBCS characters...' Convert '...SBCS and DBCS characters...' 

25 to the proper machine language 

25 representation. Requires that the DBCS 

27 option be specified. 

28 DC G'...pure DBCS characters...' Convert '...pure DBCS characters...' to the 

29 proper machine language representation. 
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1 Requires that the DECS option be 

2 specified. 
3 

4 The DC (Define Constant) statement has this general form: 

5 label DC (DUPLICATION_FACTOR)(TYPE)(MODIFIERS)'(NOMINAL_VALUE)' 

6 where the parentheses simply delimit the various fields, and are not part of the syntax of the 

7 statement. In general, only the TYPE and NOMINAL_VALUE fields are required. For 

8 example, a statement defining a character constant could be written: 

9 DC CThis is a character constant' 

1 0 where the TYPE is indicated by the letter C. 
11 

1 g In the general form of the DC statement, each of the parenthesized terms has the 

l|T following meanings: 



The optional DUPLICATION_FACTOR field specifies that the constant defined by the 
following elements should be repeated a specified number of times. For example, 
DC 3C'XYZ=' 

would generate a machine language constant from the character string 
'XYZ=XYZ=XYZ=\ containing three repetitions of the nominal value string 'XYZ=\ 



21 2. TYPE specifies the type of encoding to be created for the values specified in the 

22 NOMINAL_VALUE field. In a preferred embodiment of the present invention, types 

23 of specific interest and applicability are Types C and G, for "Character" and "Graphic" 

24 constants, respectively. Other TYPE values are used to indicate that the 

25 NOMINAL_VALUE data should be converted to machine language data 

26 representations such as binary integer, floating point, packed decimal, and others as 

27 described in the "High Level Assembler Language Reference" citation. 
28 

29 The TYPE specification may also include a "subtype" specification to provide 



1 

161 
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1 additional refinements in the type of conversion to be performed. For example, the '*D*' 

2 type indicates that the NOMINAL.VALUE is to be converted to an eight-byte floating 

3 point representation; two subtypes are supported, such that "DH" indicates conversion 

4 to hexadecimal floating point, and "DB" indicates conversion to binary floating point. 
5 

6 3. MODIFIERS specify additional information to be used in creating the generated 

7 machine language constant. A preferred embodiment of the invention is primarily 

8 concerned with the "Length" modifier, which asserts the exact length required for the 

9 generated data. An additional modifier may be used for specifying code pages to be 
1 0 used in converting individual constants. 

11 

1 2- 4. NOMIN AL_V ALUE is the data to be converted. A preferred embodiment of the 

present invention is concerned with character data in three forms: SBCS data, mixed 

1^ SBCS/DBCS data, and pure DECS data. 

ypQ Literals 

iy 

17 

1 ^ Literals are a convenient form of declaring a constant in the immediate context of its 

1^; use. For example, to set the address of a character constant into General Purpose Register 2, a 

2ffi programmer may write the "Load Address" (LA) instruction thus: 
LA 2,=C*A Character Constant' 

22 where the equal sign indicates to the assembler that the following operand is a literal constant. 

23 The assembler effectively creates a hidden internal name for the constant, replaces the literal 

24 operand in the statement by the internal name, and places the text of a statement defining the 

25 constant labeled with the internal name in a designated (or default) place in the program. This 

26 saves the programmer from having to write two statements, such as: 

27 LA 2,Char_Const 

28 — other statements 

29 Char-Const DC C'A Character Constant* 
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1 Literals can easily be supported for all constant types described in this preferred 

2 embodiment of the present invention, and will therefore not be discussed fiirther; such support 

3 is assumed throughout. 
4 

5 The assembler also supports specialized forms of character-like data called "self- 

6 defining terms". These comprise decimal, binary, hexadecimal, character, and graphic (pure 

7 DECS) forms. The values of all self-defining terms are fixed and predefined by the assembler. 

8 For example, the self-defining terms 193, B'l 1000001', X'Cl', and C'A' are required to have 

9 identical values. For this reason, no dependence on code page specifications can be allowed for 
1 0 character or graphic self-defining terms, as their values would not be fixed. 

11 

1 2 In the IBM High Level Assembler, the syntactic character set consists of 

133 (a) upper-case and lower-case letters; 

l|i (b) decimal digits; and 

1 1 J (c) the special characters: + -/ *., ()@#_&' = blank. 

1 63 (d) The syntactically significant alphabetic character "$" ("currency symbol") is not invariant 

1 2" across EBCDIC code pages; the Assembler Language requires it to have encoding X'5B', or 9 1 

I§=f decimal. 

2ip; Other characters are invariant across code pages, but they are not syntactically 

2V significant: 

22 ;:?"%<> 

23 

24 The invariance or non-invariance of various syntactic characters is not significant to this 

25 preferred embodiment of the present invention, other than providing a vehicle for the proper 

26 recognition of character strings to be converted to Unicode. The character set used in character 

27 data may contain SBCS and DBCS character encodings fi-om many possible code pages 

28 without affecting the syntactic or semantic behavior of the program, because the contexts 

29 specifying data to be converted to Unicode are limited and well defined. 
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1 This preferred embodiment supports the common programming practice that source 

2 programs (symbols, operation codes, etc.) are always created using a syntactic character set, 

3 which includes those characters needed by the assembler or other programming-language 

4 translator to correctly parse and tokenize the elements of the source program, and to identify 

5 those program elements specifically requesting conversion to Unicode. Conversion-specific 

6 character data appears only in restricted contexts, between the enclosing apostrophes of the 

7 CU-type or GU-type constants described below. Text to be converted may therefore be 

8 encoded in any desired manner. 
9 

10 Although the preferred embodiment described uses the Extended Binary Coded 

1 1 Decimal Interchange Code (EBCDIC) for all but character data, this invention applies to any 
IL conventional character set used for creating programs, such as ASCII. 

m 
iS 

r 

1^ A. Source Data Specification Extensions for Unicode 

m 

1^ A syntax suitable for specifying character data conversion from SBCS, mixed 

Ip SBCS/DBCS, and pure DECS representation to Unicode utilizes the constant subtype notation 

1^ described above. To specify that the nominal value of character data is to be converted to 

2^IG Unicode, a programmer may write: 

2V DC CU'...SBCS data...' Convert SBCS to Unicode 

22 DC CU'...SBCS/DBCS data..." Convert mixed SBCS/DBCS to Unicode 

23 Requires DECS option 

24 DC GU'...pure DBCS data...' Convert pure DBCS data to Unicode 

25 Requires DBCS option 

26 The first of these is called "pure SBCS data" or simply "SBCS data". The second is called 

27 "mixed SBCS/DBCS data", or simply "mixed data". The third is called "pure DBCS data". 
28 

29 In the preferred embodiment using the IBM High Level Assembler, the second and third 



STL9-2000-0055 



1 of these examples require that the DBCS option be specified so that mixed SBCS/DBCS data is 

2 recognized correctly, but other forms of recognition rules or syntaxes for the nominal value 

3 could also be used. 
4 

5 Another language extension provided by the preferred embodiment defines a new 

6 constant type specifically for Unicode by assigning a TYPE code 'U'. Thus, a constant to be 

7 converted to Unicode may be written: 

8 DC UText to be converted' 

9 which could be equivalent in other respects to a constant of type C. If this form is chosen, an 

10 additional type letter would also have to be assigned to accommodate pure DBCS data, by 

1 1 analogy with the G-type constant. Because the assembler has already assigned a large range of 
1 2=H letters for constant types, the method using a 'U' subtype described above is more economical 

1 P in its use of the available set of type codes. 

m 

1^ In converting the nominal value data to Unicode, the assembler uses the currently 

1^ relevant SBCS and DBCS code pages, as derived fi-om global options or fi-om local 

i J 

AOPTIONS statement specifications, or from constant-specific modifiers, as described below. 

% 

^ As with other character-based data types, no particular data alignment in storage is 

M assumed. However, since Unicode data naUirally occurs in two-byte (sixteen-bit) forms, data 

if alignment on two-byte boundaries could easily be supported if processing efficiencies indicate 

22 that doing so would be beneficial. 

23 

24 To simplify usage of these new constant types, the syntax of CU-type and GU-type 

25 constants preferably should be unchanged fi-om the current language definition for C-type and 

26 G-type constants. This allows users who are familiar with existing coding styles and 

27 conventions (i.e., the syntax of C-type and G-type constants) to utilize this invention with 

28 minimal additional effort. 
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1 B, Methods for Specifying Source Code Pages 

2 

3 There are three levels, or "scopes", at which source code pages can be specified: 

4 1 . Global code page specifications that apply to the entire source program: these "global" 

5 specifications allow the programmer to declare the source-program code page or code 

6 pages just once. These specifications then apply to all constants containing a request for 

7 conversion to Unicode. 

8 2. Local code page specifications that apply to all subsequent source-program statements: 

9 these "local" specifications allow the programmer to create groups of statements 

1 0 containing Unicode conversion requests, all of which use the same code page or code 

1 1 pages for their source-character encodings. For example, a program might contain 
12, statements defining messages in each of several national languages; each grouping 

1^ could be preceded by such a "local" code page specification that applies to all the 

f ?^ 

1^^ statements of that group, until a subsequent local specification is provided that applies 

r 

l'^ to the following group. 

1^ 3. Individual constant code page specifications that apply to individual constants: these 

\f allow a very detailed level of control over the source data encodings to be used for 

f^ Unicode conversion. For example, if a message in one national language must contain a 

Ip^ segment written in a different national language, each segment of the message can 

2l%^ specify the encoding used for its characters. 

2P 

22 

23 B.l. Global Source Code Page Specification 

24 

25 Global source code specifications apply to all DC ("Define Constant") statements in the 

26 source program to which Unicode conversion should be applied. These global specifications 

27 would typically be specified as "options" or "parameters" presented to the Assembler at the 

28 time it is invoked or initialized, so that the Assembler can set up any needed information that 

29 will apply to the entire source program translation. 
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1 The forms that such global source code specification options may take include: 

2 CODEPAGE(nnn) specifies a SBCS code page 

3 CODEPAGE(nnn,nnn...) specifies a set of SBCS code pages (Example 1 ) 

4 CODEPAGE(nnn,sss) specifies a SBCS code page and a DECS code page 

5 DBCS(sss) specifies a DBCS code page and enables recognition of DECS 

6 data 

7 DBCS(sss,sss,...) specifies a set of DBCS code pages and enable recognition of 

8 DBCS data (Example 2) 

9 DBCS(CODEPAGE(sss)) specifies a DBCS code page and enables recognition of DBCS 
] 0 data 

1 1 and so forth, where values such as nnn and sss are Coded Character Set IDs (CCSIDs). 

12= Combinations and variations of the above, as well as abbreviations of the keywords, are equally 

1 33 useful. Default code page values can also be specified at the time the Assembler is installed on 

In 

ijs. the user's system, allowing Unicode translations to be specified in the program without the 

1 need for invocation or initialization options. 

l|3 

1 7" In addition to these "invocation" options, the preferred embodiment allows the user to 

1 |i specify certain options to be included in the statements of the source program, using the 

1 *PROCESS statement. Thus, any of the above option forms could be placed in the source 

n 

2lh module with a statement like: 

2^3 *PROCESS CODEPAGE(nnn) 

22 and so forth, for all possible variations. An additional capability is provided with the 

23 *PROCESS statement: if the OVERRIDE(..,) option is specified, as in: 

24 *PROCESS OVERRIDE(CODEPAGE(nnn)) 

25 With the OVERRIDE(...) option, the user can thereby specify that no matter what CODEPAGE 

26 options are specified when the Assembler is invoked, the global CODEPAGE value or values 

27 cannot be changed from the value(s) required to produce correct conversion of the constants in 

28 the source program. 
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B.2, Local Source Code Page Specification 



The IBM High Level Assembler provides a mechanism allowing users to make local 
adjustments or overrides to options that can also be specified "globally". This mechanism is 
the ACONTROL statement. For example, if the user wishes that the assembler not diagnose 
certain substring operations, the user may specify: 

ACONTROL FLAG(NOSUBSTR) (Assembler ignores possibly-invalid substring 

techniques) 

— statements with unusual substring coding techniques — 
ACONTROL FLAG(SUBSTR) (Assembler resumes checking substring 

techniques) 

The ACONTROL statement can be used to specify localized controls over the source 
code pages to be used for converting designated forms of character data to Unicode. For 
example, distinct groups of statements can be converted to Unicode from separate code pages 

as follows: 

ACONTROL CODEPAGE(nnn) 

— statements with character data to be converted to 

— Unicode using code page with CCSID nnn 
ACONTROL CODEPAGE(mmm) 

— statements with character data to be converted to 

— Unicode using code page with CCSID mmm 
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1 Alternatively, if it is desired to specify multiple code pages to be used in converting 

2 constants in subsequent statements, the ACONTROL statements could be specified in 

3 alternative forms, such as: 

4 .* Example 3 

5 ACONTROL CODEPAGE(nnnl,nnn2,..),DCBS(CODEPAGE(sssl,sss2,...)) 

6 — statements with character data to be converted to Unicode 

7 — using code pages selected among the nmi and sss values 

8 .* Example 4 

9 ACONTROL C0DEPAGE(mmml,mmm2,...),DBCS(C0DEPAGE(tttl ,ttt2,...)) 

1 0 — statements with character data to be converted to Unicode 

1 1 — using code pages selected among the mmm and ttt values 

12_ Thus, all the various formats of "global" options could be specified on ACONTROL 

V -r, 

1^ Statements. 

ly In cases where the user wishes to revert from a local source code page specification to 

f 3 

1^ the global source code page specification, the following special notation may be used: 

^ ACONTROL CODEPAGE(*) (Revert to global source code page specifications) 

l'^ 

1-^^ Later, conversion and implementation techniques are described that involve methods 

id, that do not require direct implementation in the assembler itself, such as macro instructions and 

2^0 external ftinctions. To assist such methods, the assembler can capture information from the 

22 options and/or ACONTROL statements in global system variable symbols. These system 

23 variable symbols are a method whereby the assembler can provide environmental and status 

24 information to macros and functions. In implementing conversion to Unicode data formats, the 

25 assembler can capture the designations of current code pages in system variable symbols such 

26 as: 

27 &SYS_SBCS_CODEPAGE current SBCS code page 

28 &SYS_DBCS_CODEPAGE current DECS code page 

29 The advantages of this increment in assembler capability will be illustrated below. 
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1 B.3. Specifying Source Code Page for Individual Constants 

2 

3 The most discriminating level of code page specification is at the level of an individual 

4 constant. This invention involves adding a novel modifier, - P meaning "Code Page"--, to the 

5 existing syntax for specifying constants to provide information about the code page or code 

6 pages used to create the source data for the constant. 
7 

8 To provide code page specifications for individual constants, another novel form of 

9 modifier is introduced: 

10 DC CUP(nnny...SBCS data../ 

1 1 which requests that the SBCS data provided using code page "nnn" be converted to Unicode. 
1I3 DC CUP(nnn,sss)'...mixed SBCS/DBCS data...' 

1 1: requests that the mixed SBCS/DBCS data provided using code page "nnn" for the SBCS data 

lijy and the code page "sss" for the DBCS data be converted to Unicode. 
m DC GUP(sss)'...pure DBCS data...' 

I W requests that the pure DBCS data provided using code page "sss" be converted to Unicode. 
IP 

ip, The above examples demonstrate the use of an explicit numeric specification of the 

ik' value of the code page modifier. It is common practice in programming languages to use 

2© symbolic forms for important numeric quantities; this invention supports this technique. For 

2 1 example, if the statement: 

22 MyCodePage Equ 1148 

23 is used to declare that the symbol "MyCodePage" is equivalent to the value 1 148, then the 

24 following two statements will be treated identically: 

25 DC CUP( 1 1 48)'Text using code page 1 1 48' 

26 DC CUP(MyCodePage)'Text using code page 1 148' 

27 Thus, uses of this invention are not limited to strictly numeric specification of CCSIDs in all 

28 programming contexts. 
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1 For situations where more than one SBCS or DECS code page is currently available (as 

2 exemplified in Examples 1, 2, 3, and 4 above), individual constants could refer indirectly to 

3 one of the previously specified code pages using a special "indicator" notation to select the 

4 desired code page. For example, suppose the ACONTROL statement of Example 3 

5 immediately preceded these constants: 

6 DC CUP(= 1 )'Convert this with code page nnn 1 ' 

7 DC CUP(=2)'Convert this with code page nnn2' 

8 The notations "=1 " and "=2" are intended to indicate that the first and second code pages 

9 declared in the ACONTROL statement should apply to each respective constant. The choice of 

10 the character is of course arbitrary, and could be any character not allowed in valid 

1 1 language symbols. This level of constant-specific code page specification could also be used 
iQ with U-type constants, as described above. Additional modifiers (such as length) can also be 

supported without any modifications to the existing language rules or implementation within 

1^1 the assembler. 

a 

^ C. Conversion Techniques 

m 

l§ Three alternative embodiments for implementing the conversion of source data to 

?== 

i§ Unicode will be described: 

m 1 . The implementation is inherent to the assembler itself: the assembler recognizes and 

2 1 parses the complete syntax of the statement in which the constant or constants is 

22 specified, and performs the requested conversion. 

23 2. The implementation is provided in the form of an external function that can be invoked 

24 by a variety of source language syntaxes. The external function can parse as little or as 

25 much of the source statement as its implementation provides, and return the converted 

26 value to the assembler for inclusion in the generated machine language of the object 

27 program. 

28 3. The implementation is provided by the assembler's macro instruction definition facility. 

29 Each of these implementation techniques will be illustrated below. 
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Mapping Tables 



A key element of the conversion process is the Mapping Table. One mapping table is 
created for each source code page, as identified by its CCSID. Each mapping table contains the 
Unicode character corresponding to each single-byte or double-byte character in the specified 
coded character set, arranged in ascending order of the numeric encoding assigned to each 
source character, as illustrated in Figure 2. 

A Mapping Table 280 typically consists of a fixed-length header 282 containing a 
number of fields identifying the table and its status, so that the assembler can verify that the 
correct table is being used for the requested conversion. Following the header are the Unicode 
characters 284, 286, and 288 in the exact order of the numeric encoding assigned to the 
corresponding source character. 

Thus, the Unicode character corresponding to the source character having a numeric 
encoding value of 1 would be found at 286, Similarly, the Unicode character corresponding to 
the source character having a numeric encoding value of k would be found at 288. 

A Mapping Table for a SBCS character set would typically have two-hundred-fifty-six 
Unicode character entries, while a mapping table for a DECS character set could have as many 
as sixty-five-thousand-five-hundred-thirty-six (65536) Unicode character entries. If it is known 
that certain restrictions may be imposed on the range of encoding values permitted for the 
source characters, then the contents of the mapping tables can be optimized to take advantage 
of those restrictions. For example, typical DECS character encodings do not permit 
assignment of numeric encoding values less than sixteen-thousand-seven-hundred-five 
(16705), so that mapping table entries would not be necessary for converting those encodings. 

Note that for any given constant, either one or two mapping tables will be required for 
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1 converting the nominal value of the constant to Unicode. For SBCS and pure DBCS data, only 

2 a single mapping table is needed; for mixed SBCS/DBCS data, two mapping tables are 

3 required: one for the SBCS data and one for the DBCS data. 
4 

5 Table 1 illustrates typical assignments of Coded Character Set IDs (CCSIDs) 

6 commonly used for single-byte encodings of character sets in widespread use. Further details 

7 may be found in the manual "IBM National Language Design Guide, Volume 2" (manual 

8 number SE09-8002-03). 
9 

10 



Table 1 

Examples of CCSIDs for Commonly Used SBCS Character Sets 



. ==1 


SBCS CCSID 


DESCRIPTION 


M 

s : 


01140 


USA, Canada, Netherlands, Portugal, Brazil, Australia, New Zealand 


!* ^ 




(00037 with euro) 


m 


01141 


Austria, Germany (00273 with euro) 




01142 


Denmark, Norway (00277 with euro) 




01143 


Finland, Sweden (00278 with euro) 




01144 


Italy (00280 with euro) 




01145 


Spain, Latin America (Spanish) (00284 with euro) 


20 


01146 


United Kingdom (00285 with euro) 


21 


01147 


France (00297 with euro) 


22 


01148 


Belgium, Switzerland, International Latin- 1 (00500 with euro) 


23 
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Table 2 shows examples of typical code pages used for DBCS data in pure DBCS or 
mixed SBCS/DBCS contexts. 



Table 2 

Examples of DBCS Code Pages Suitable for Unicode Conversion 



DBCS CCSID 


DESCRIPTION 


00935 


Simplified Chinese (S-Chinese) Host Mixed (including 1880 UDC and 
Extended SBCS) 


00937 


Traditional Chinese (T-Chinese) Host Mixed (including 6304 UDC and 
Extended SBCS) 


04396 


Japanese Host Double-Byte (including 1880 UDC) (User Definable 
Characters) 


09125 


Korean Host Mixed (including 1880 UDC) 



CL Assembler Implementation 

To adapt the CCSID of a mapping table to a format usable by internal or operating 
system services to locate the required mapping table, the assembler can employ a variety of 
methods. One such technique uses the observation that each CCSID is sixteen bits long, and 
that its hexadecimal representation therefore contains exactly four hexadecimal digits. For 
example, CCSID number 01 148 is equivalent to the hexadecimal value X'047C\ If those four 
hexadecimal digits are converted to character form, they can be attached to a standard prefix 
and used as a module name. For example, in the IBM High Level Assembler, such a module 
name could be created from a prefix 'ASMA* and a suffix given by the four hexadecimal digits, 
in this case 'ASMA047C\ This constructed name can then be used as the name of the mapping 
table in all service requests involving finding and loading the mapping table. 
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1 Referring now to Figure 3 and Figure 4, the flowcharts illustrate the operations 

2 preferred in carrying out the preferred embodiment of the present invention. In the flowcharts, 

3 the graphical conventions of a diamond for a test or decision and a rectangle for a process or 

4 function are used. These conventions are well understood by those skilled in the art, and the 

5 flowcharts are sufficient to enable one of ordinary skill to write code in any suitable computer 

6 programming language. 
7 

8 Referring first to Figure 3, the conversion proceeds as follows. After the start 302 of 

9 the conversion program, the assembler establishes at process block 304 the code page or code 

10 pages used in the source text for specifying the nominal value of the data to be converted to 

1 1 Unicode. Thereafter, at decision block 306, the assembler determines whether the mapping 
123 tables needed for converting source data written in the source-data code pages are currently 

available. If they are, the assembler proceeds to process block 314 to begin the conversion 

ik^ process. Otherwise, if the mapping tables needed for the conversion are not currently available, 

1 13 then the assembler at process block 307 uses standard operating system services to load the 

1 |l appropriate mapping table. Thereafter, decision block 308 determines if the load of the 

1 1„ mapping table was successful. If for any reason the loading process fails, then the assembler at 

1 8 J process block 310 issues appropriate error messages and terminates its attempt to convert the 

1^ constant 312. 

21 Returning now to process block 314, to begin the conversion process the assembler 

22 parses the source string to determine the number of characters it contains. These source 

23 characters can be SBCS or DECS characters. The number of these characters is assigned to the 

24 variable NCS. Then, at process block 316, the assembler sets a counter "K" for characters from 

25 the source string to 1 . Thereafter, assembler process block 318 extracts the K-th character from 

26 the source string. Using the binary value of the character (which will be an 8-bit value for 

27 SBCS characters, and a 1 6-bit value for DECS characters), assembler process block 320 

28 extracts the Unicode character from the mapping table that whose position corresponds to that 

29 binary value. This extracted value is then stored in the K-th position of the target string, as 
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1 illustrated in Figure 2. 

2 

3 After each Unicode character is stored in the target string, assembler process block 322 

4 increases the value of K by one, and its new value is then compared to the number of characters 

5 NCS by decision block 324. If the value of K does not exceed the value of NCS, program 

6 control is returned to process block 318 to obtain and convert the next source character. If the 

7 value of K exceeds the value of NCS, then conversion of the constant is complete, and the 

8 Unicode character string is placed in the machine language of the object file for the program by 

9 process block 326. Thereafter, the program ends at process block 312. 
10 

1 1 The process of selecting source-string characters in process steps 316 through 324 of 

iD Figure 3 are described in greater detail in Figure 4 to show how SBCS and DBCS source 

ISfi characters are selected. The source string is assumed to have previously been validated for 

1^^ syntactic and semantic correctness. After the start 402 of the scanning process, the scanning 

iW process is initialized 404 by setting a scan pointer to the address of the first byte of the source 

1^ string, the nominal value of the constant. Initialization also sets a binary switch to indicate that 

\% the scan will proceed initially in "Single-Byte" mode. This switch is also used to determine 

W which Mapping Table (SBCS or DBCS) should be used to translate source characters to 
Unicode. 

2 1 Thereafter, the byte pointed to by the scan pointer is checked by decision step 406 to 

22 see if it is a "Shift-Out" character, indicating the start of a DBCS string. If the character is not a 

23 Shift-Out character, program control proceeds to process step 408 which determines that the 

24 source characters are part of an SBCS character set. Process step 408 also uses the source 

25 character pointed to by the scan pointer as the index into the SBCS Mapping Table, as 

26 indicated in process step 320 of Figure 3, to perform the translation of process step 410 which 

27 translates the source character to Unicode. Thereafter, process step 412 increments the scan 

28 pointer by one byte to point to the next byte of the source string. Decision step 414 then 

29 determines if the scan pointer now points past the end of the source string. If the scan pointer 
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1 now points past the end of the source string, then the translation is complete, process step 416, 

2 and the assembler resumes normal statement processing, process step 418. 
3 

4 Returning now to decision step 406, if the byte pointed to by the scan pointer is a 

5 "Shift-Out" character, then control proceeds to process step 420 which increments the scan 

6 pointer by one byte, effectively discarding the "Shift-Out" character. The binary switch 

7 described at process step 404 is also set by process step 420 to indicate DBCS mode, thereby 

8 allowing selection of the current DBCS Mapping Table to perform the translation as illustrated 

9 in Figures 2 and 3. Thereafter, process step 422 uses the two bytes pointed to by the scan 

1 0 pointer as the source character. Process step 424 then translates this source character to 

1 1 Unicode using the DBCS Mapping Table. After the translation of the DBCS two-byte 

1 23 character, control proceeds to process step 426 which increments the scan pointer by two bytes 

1 m to step over the DBCS source character just translated. Decision step 428 tests the following 

iC byte to determine if it is a "Shift-hi" character, which would indicate the end of the DBCS 

■a ^ 

1 P portion of the source string. If the tested byte is not a "Shift-In" character, then program 

iBj control returns to process step 422 to process the next DBCS source character. Otherwise, if 

15':, the byte tested by decision step 428 is a "Shift-In" character, then program control proceeds to 

process step 430 which resets the binary switch to indicate that SBCS mode is now active. 

\B Thereafter, program control passes to the previously described process step 412 which 

M increments the scan pointer by one byte, effectively discarding the "Shift-In" character. 

21 
22 

23 C.1.1. Length Modifiers 

24 

25 The Length modifier is supported by the assembler for most constant types. For 

26 character constants, it is written in the form: 

27 DC CL(m)This is a Character Constant' 

28 where the generated machine language object code for the constant is required to have length 

29 exactly "m" bytes. This means that the character string in the nominal value field could either 
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1 be truncated (if m is smaller than the length of the nominal value string), or padded on the right 

2 with blanks (if m is larger than the length of the nominal value string). In the case of Unicode 

3 constants the implementation may or may not require that any length modifiers of the form: 

4 DC CUL(m)'...' 

5 DC GUL(m)'<...>' 

6 must evaluate to even values of "m". If "m" is odd (indicating that a Unicode character does 

7 not contain the expected 1 6 bits), a diagnostic may be given and corrective action may be 

8 taken. 
9 

10 

1 1 C.2. Implementation Using Macro Instructions 

12-1 

1 3^ Many assembler programs support some form of "macro-instruction" capability that 

ik^ allows the progranuner to create new capabilities whose invocations resemble ordinary 

iJ 

IgK instructions. 

'K 

If C.2.1. Macro Instruction to Perform Basic Checking 

m 

lif The most trivial level of Unicode support could be a macro instruction whose argument 

i K 

W is a character string of hexadecimal digits, in which the user has manually encoded the 

2'f representation of each Unicode character. The primary function of such a macro could be 

22 validate that the argument string contains a multiple of four hexadecimal digits corresponding 

23 to an integral number of Unicode characters, and that each group of four hexadecimal digits 

24 corresponds to a true Unicode character. For example, a DCUX macro instruction could be 

25 written such that the user might write: 

26 DCUX X*...hex data...' 

27 or 

28 DCUX '...hex data...' 

29 or 
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DCUX ...hex_data... 

and the macro could verify that the number of hexadecimal digits is a multiple of 4, and that 
the Unicode characters are valid. 

C.2.2. Macro Instruction to Perform Checking and Conversion 

A more powerful technique for supporting the conversion of character data to Unicode 
characters is to create a macro definition with internal logic that performs a mapping similar to 
that illustrated in Figures 3 and 4. Implementation of such a macro definition could also 
include any needed mapping tables within the body of the definition. 

An advantage of using macro instructions is that they utilize the existing facilities of the 
assembler, and therefore do not require changes to the internal operation of the assembler. 
Their primary disadvantage is that macro definitions must be executed interpretively when 
invoked, so they are slower than the same fiinction implemented "natively" in the internal logic 
of the assembler. They also require extra coding for each additional code page being 
supported. Thus, macro instructions provide an excellent means for testing and validating 
conversion concepts, as well as a rapid development tool for situations where generality and 
speed are not critical. 

In a typical implementation, a macro instruction would be defined in such a way that its 
arguments include a character string to be converted to Unicode, and an implicit indication 
(using the system variable symbols described above) or explicit indication (by providing a 
descriptive argument) of the CCSID of the code page in which the character string is 
represented. The macro instruction would then generate directly the machine language 
constant containing the Unicode data. 

There are many ways to use macros for Unicode conversions. To illustrate, suppose the 
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1 following syntax is defined: 

2 DCU '...character data...',CODEPAGE=nnn,DBCS=sss 

3 where the three operands have these meanings: 

4 1 . The first operand, '...character data...', consists of the character data to be converted to 

5 Unicode, enclosed in quotation marks recognizable by the macro processor. 

6 2. The second operand, CODEPAGE=nnn, specifies the SBCS code page used for 

7 encoding the first operand. If omitted, this operand would imply a default value for the 

8 code page. 

9 3. The third operand, if present, indicates that the first operand contains either mixed 

10 SBCS/DBCS or pure DBCS data, and provides the code page in which the DBCS data 

1 1 is encoded. If omitted, this operand would imply that the first operand contains only 
12^ SBCS data. 

lid. An implementation of such a macro instruction which may be used to create Unicode 

Ip. character constants is illustrated in Figures 5, 6, and 7. It does not support the third operand 

1 13 described above, but is intended to illustrate how a macro instruction can be used for Unicode 

III 

1 ¥ conversions. The macro uses the default code page with CCSID 500, the same as that used by 

1^1 the assembler for its syntactic character set plus other invariant characters. Extending the 

lit macro to accept other code pages is straightforward. 

fl 
IT 

22 C.3. Implementation Using External Functions 

23 
24 

25 The High Level Assembler supports a powerful capability for calling extemally- 

26 provided fiinctions that can perform a variety of processing operations. Using an external 

27 function requires defining the function in such a way that the assembler can locate and call it 

28 during the assembly process, passing data supplied by the program to the function, and 

29 receiving values returned by the function. In the context of converting character data to 
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1 Unicode, a call to such a function could take a form such as the following: 

2 &Retumed_Val SetCF 'Ext_Func','character data','other_parameters' 

3 The symbol "&Retumed_Val" is where the called function "Ext_Func" places its computed 

4 value as calculated from the other arguments. These arguments would typically include the 

5 character string to be converted to Unicode, the code page or code pages used in coding the 

6 character data, and any other values that might be useftil to the external function. \n practice, 

7 the returned value would normally be substituted into a character or hexadecimal 

8 constant, which the assembler would then map directly into the machine language form of the 

9 Unicode constant. 
10 

1 1 An extemal function has much of the flexibility of the assembler itself: it can access 

I2ji mapping tables as needed, as well as any other services of the operating system environment in 

1 which the assembler itself is executing. Any error conditions can be reported to the assembler 

r 

; : c 
- 

14^ using a message passing interface. 

1 19 Further implementations of Unicode conversions could use a mixture of macro 

1 7 instructions and extemal functions, in such a way that the user writes a statement such as the 

1 §1 following: 

1^ DCUNI '...character data...',CODEPAGE=37 

2Ci and the macro instruction could then pass the character data, the code page CCSID, and any 

iT other useful or necessary information to an extemal function to perform the required 

22 conversion. It could also generate the character or hexadecimal constant directly, in such a way 

23 that the above DCUNI instmction appears to be "native" to the assembler itself. Other 

24 implementations using extemal functions are of course possible. 
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1 UTF-8 

2 

3 UTF-8 is a special version of the Unicode representation, chosen for its suitability for 

4 transmission over communication protocols designed for eight-bit characters. These protocols 

5 are sensitive to specific eight-bit codes (such as control characters) that could appear in a 

6 stream of valid sixteen-bit Unicode characters, and the transmission of normal Unicode data 

7 would very likely be distorted. To avoid this problem, the Unicode standard defines UTF-8 as 

8 a reversible mapping of sixteen-bit Unicode characters to a special string of one to four eight- 

9 bit bytes, such that none of the eight-bit bytes have special meanings to transmission protocols. 
10 

1 1 The assembler could easily provide conversion of SBCS, mixed SBCS/DBCS, and pure 

13. DECS data to the UTF-8 representation, thus avoiding the need for possibly expensive run- 

r# time conversions for each item of Unicode data being transmitted. In terms of the previous 

1|4 discussion: 

^ 1 . Specification of a request for lJTF-8 conversion can be provided globally, using an 
^ assembler option such as UTF8, or an operand on a *PROCESS statement such as: 

hi *PROCESS UTF8 

fei 2. Specification of a request for UTF-8 conversion can be provided locally, using an 
if operand of the ACONTROL statement, such as: 

m ACONTROL UTF8 

^ f 3 . Specification of a request for UTF-8 for an individual constant can be provided by a 

22 modifier, such as: 

23 DC CUTF8'Characters to be converted to UTF-8' 

24 Thus, it can be seen that all of the methods described above for specifying the scope of 

25 conversion to Unicode can be applied to the requirements for conversion to the UTF-8 

26 representation. It should be noted that UTF-8 data is not required to occupy an even number of 

27 eight-bit bytes, so that possible checks and diagnostics for an even number of bytes would not 

28 apply. However, in situations where a length modifier causes improper truncation of a UTF-8 

29 byte string, a diagnostic would be appropriate. 
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1 Using the foregoing specification, the invention may be implemented using standard 

2 programming and/or engineering techniques using computer programming software, firmware, 

3 hardware or any combination or sub-combination thereof Any such resulting program(s), 

4 having computer readable program code means, may be embodied within one or more 

5 computer usable media such as fixed (hard) drives, disk, diskettes, optical disks, magnetic tape, 

6 semiconductor memories such as Read-Only Memory (ROM), Programmable Read-Only 

7 Memory (PROM), etc., or any memory or transmitting device, thereby making a computer 

8 program product, i.e., an article of manufacture, according to the invention. The article of 

9 manufacture containing the computer programming code may be made and/or used by 

1 0 executing the code directly or indirectly from one medium, by copying the code from one 

1 1 medium to another medium, or by transmitting the code over a network. An apparatus for 

1 2 making, using, or selling the invention may be one or more processing systems including, but 
Ig not limited to, central processing unit (CPU), memory, storage devices, communication links, 
^ communication devices, servers, input/output (I/O) devices, or any sub-components or 

1^ individual parts of one or more processing systems, including software, firmware, hardware or 

161 any combination or sub-combination thereof, which embody the invention as set forth in the 

]^ claims. User input may be received from the keyboard, mouse, pen, voice, touch screen, or any 

\W other means by which a human can input data to a computer, including through other programs 

1^ such as application programs, databases, data sets, or files. 

n 

2© One skilled in the art of computer science will easily be able to combine the software 

22 created as described with appropriate general purpose or special purpose computer hardware to 

23 create a computer system and/or computer sub-components embodying the invention and to 

24 create a computer system and/or computer sub-components for carrying out the method of the 

25 invention. Although the present invention has been particularly shown and described with 

26 reference to a preferred embodiment, it should be apparent that modifications and adaptations 

27 to that embodiment may occur to one skilled in the art without departing from the spirit or 

28 scope of the present invention as set forth in the following claims. 
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